home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc A) / Acorn User China CD-ROM (UK) (Disc A).bin / DEMON / ACORN-STARTER / STARTR_HTML.ARC / StarterHTM
Encoding:
Text File  |  1995-05-28  |  38.7 KB  |  986 lines

  1. <html>
  2. <head>
  3.  
  4. <!-- HTML document saved from Computer Concepts' Impression -->
  5. <!--      using ben's HTML saver  (c) Ben Summers 1995      -->
  6. <!--        for more info, email ben@cconcepts.co.uk        -->
  7.  
  8. <!-- Exported from document 'StarterImp' -->
  9.  
  10. <h1>Starter-Pack HTML Document</h1>
  11. </head>
  12. <body>
  13. <title>        </title>
  14. <h2>FAQ & Starter Pack Version 1.2 28th May 1995</h2>
  15.  
  16. <p>
  17. <em>
  18. *** Read this through once before doing anything else ***</em><p>
  19.  
  20. <p>
  21. <h3>Legalities & Disclaimer</h3>
  22.  
  23. <p>
  24.  
  25. Copyright 1994, 1995 Dr Alan Hassey. (alan@midwife.demon.co.uk) This document is freely distributable 
  26. in unmodified form. No charge may be made for the use of The Starter-Pack or any part of it without the 
  27. specific consent of the authors.<p>
  28.  
  29. The author takes no responsibility for the accuracy of information contained in this document. It is provided 
  30. without express or implied warranty or guarantee and its contents may be changed without notice.<p>
  31.  
  32. If you have any comments or suggestions for improvements or alterations, then please contact me at 
  33. alan@midwife.demon.co.uk.<p>
  34.  
  35. <p>
  36.  
  37. In general, queries or comments about individual applications should be addressed to the respective s/w 
  38. authors (see section D). All the authors’ copyrights and conditions of use must be preserved unless you have 
  39. their specific permission to do otherwise.<p>
  40.  
  41. Users of older RISC OS 3 machines should check whether they need the serial patch modules located in the 
  42. Starter-Pack SerialApps directory. You will not need them if you have RISC OS 3.11 or above. You may 
  43. also need a patched serial cable if you’ve got an A310, 440, 4x0/1, A3000, A540, R140, or R260 Acorn 
  44. machine. The wiring for an “Arc” type modem-lead are given in the file SerialComm.<p>
  45.  
  46.  The details of the serial port configuration is posted regularly as the:<p>
  47.  
  48. Comp.Sys.Acorn FAQ List Posting (1/2) Section 2.6.<p>
  49.  
  50. The serial modules can be found in the Starter-Pack:<p>
  51. <cite>
  52. (ref SerModules = StarterPak.SerialApps.SerModules)</cite><p>
  53.  
  54. If you are in doubt about the modules, then read the ReadMe file:<p>
  55. <cite>
  56. (ref ReadMe = StarterPak.SerialApps.SerModules.ReadMe)</cite><p>
  57.  
  58. The “Arc” wiring for a modem-lead can be found in:<p>
  59. <cite>
  60. (ref SerialConn = StarterPak.SerialApps.SerialConn)</cite><p>
  61.  
  62. <p>
  63. <h3>Helpful Hints > modem-leads, PC vs Arc</h3>
  64.  
  65. <p>
  66.  
  67. If you have a copy of ArcTerm7 there is an easy test you can apply to check which type of modem-cable 
  68. you have. In ArcTerm7, select the driver as internal_pc (or sp_dualpc). Now check the status line near the 
  69. bottom right of the screen. If ArcTerm7 thinks the modem is permanently online (even with the modem 
  70. switched off), then it’s an Acorn cable, so use the internal (or sp_dual) serial driver. (Courtesy of Hugo 
  71. Fiennes)<p>
  72.  
  73. For users of !Hearsay there is also a quick test to check-out your modem lead. use the Terminal setup->Misc 
  74. sub menu and open the command line editor. You enter the line:  {tprinti(devdcdbit) } followed by 
  75. <return>. If this prints 0 on the terminal you have an old style (Arc) modem lead, if it prints 1, then you 
  76. have a PC lead. This will only work if Hearsay is *not* set up for block operation.<p>
  77.  
  78. NB. !Hearsay does NOT need the block-drivers. (Courtesy of David Pilling)<p>
  79.  
  80. <p>
  81. <h3>Contents</h3>
  82.  
  83. <p>
  84.  
  85. A. Introduction<p>
  86.  
  87. B. Starter-Pack contents<p>
  88.  
  89. C. Connecting to the Internet<p>
  90.  
  91. D. Acknowledgments<p>
  92.  
  93. <p>
  94. <h3>A. This Guide / FAQ / Manual</h3>
  95.  
  96. <p>
  97. <h4>Introduction</h4>
  98.  
  99. This Guide is a short (and friendly) introduction to The Internet for Acorn RISC OS 3.1+ computer users. 
  100. The Guide is written primarily for those connecting to the Internet via Demon. Most Acorn users seem to 
  101. have a found a home of sorts at Demon and most of the help, advice and software you will need is there. 
  102. (Though not from Demon Support!). It should be fairly simple to change the configuration setup to suit 
  103. other service providers. Most of these changes will be to the !Slipdial scripts. <p>
  104.  
  105. The main aim of the guide is to get you up and running with your Acorn computer in the minimum possible 
  106. time and with the minimum fuss.<p>
  107.  
  108. The guide is not comprehensive and will not tell you everything you always wanted to know about the net... 
  109. but it will tell you enough to configure your computer and a basic set of software. The Internet Starter-Pack 
  110. will provide you with software to perform the following functions:<p>
  111.  
  112. Dialup connection to Demon Internet<p>
  113.  
  114. News/Email facilities<p>
  115.  
  116. Telnet/ftp facilities<p>
  117. The Starter-Pack does not provide a browser or other s/ware for access to the World-Wide-Web, though this 
  118. s/ware is available for download from Demon’s ftp site.<p>
  119.  
  120. You will not need any special technical skills to follow the guide or configure your system. If I can manage 
  121. it, then so can you!<p>
  122. <em>
  123. Read the Guide right through once before you start unpacking anything!</em><p>
  124.  
  125. The Starter-Pack software & guide will only be posted to Demon & Arcade BB initially, but feel free to 
  126. pass it on anywhere else you think it might be useful. Only use the latest version of The Starter-Pack. You 
  127. must also ensure that the version of this Guide matches the Starter-Pack version!<p>
  128. <cite>
  129. (ref ftp.demon.co.uk - in directory /pub/archimedes/acorn-starter-pak)<p>
  130.  
  131.                        (files are StarterTXT, sparkplug & StarterPak)</cite><p>
  132. <cite>
  133. (ref ARCADE BBS = 0181 654 2212)</cite><p>
  134.  
  135. Once you are connected, most of the software you need is available via the Demon Internet FTP (File 
  136. Transfer Protocol) site: ftp.demon.co.uk - in directory /pub/archimedes.<p>
  137.  
  138. Unfortunately, Demon Support seem to know almost nothing about Acorn computers, though there are now 
  139. signs of this changing! <p>
  140.  
  141. (Dave Williams - Dave@demon.net is trying to educate Demon about Acorn RISC OS computers!)<p>
  142.  
  143. The best place to get help and advice is probably via the newsgroups (see below). The group: 
  144. demon.ip.support.archimedes is particularly useful.<p>
  145. <h3>B. Starter-Pack Contents</h3>
  146.  
  147. <p>
  148.  
  149. This guide should be enough to get you started. For more detailed help  and advice, I have included several 
  150. other documemts in the FAQs directory<p>
  151. <cite>
  152. (ref FAQs = StarterPak.Docs.FAQs)</cite><p>
  153. <em>
  154. These are:</em><p>
  155.  
  156. 1. Demon <Dir>   - Demon Internet files (see files 1a - h below).<p>
  157.  
  158.  1a ModemTxt      - Demon’s “ModemTxT” FAQ - Modem setup textfile.<p>
  159.  
  160.  1b Welcome        - Demon’s “Welcome” FAQ.<p>
  161.  
  162.  1c VirtPoPs          - Demon’s virtual PoPs phone list.<p>
  163.  
  164.  1d Services           - Demon services<p>
  165.  
  166.  1e ServersUPd      - Up to date list of Demon gateways.<p>
  167.  
  168.  1f WWW_TxT      - Demon’s introduction to the World Wide Web.<p>
  169.  
  170.  1g BatchFTP         - Demon’s batch FTP service - FAQ.<p>
  171.  
  172.  1h RoadMap         - Pointer to resources for new users.<p>
  173. 2. Acorn FAQ        - Kevin Quinn’s FAQ - Using Acorns for Internet access.<p>
  174.  
  175. 3. Guide1_21         - Paul Allen & The ARM Club’s KA9Q guide (to TCPIP v1.21).<p>
  176.  
  177. 4. Zynet <Dir>       - Zynet info<p>
  178.  
  179.  4a ZynetFAQ        - Information about Zynet.<p>
  180.  
  181. 5. ScriptHelp          - How to edit/write !Slipdial scripts.<p>
  182.  
  183. 6. Useful?               - Miscellaneous hints & tips.<p>
  184.  
  185. 7. Freenet <Dir>     - This module & its associated programs are going to  revolutionise access to the              
  186.                                   Internet for RISC OS users!<p>
  187.  
  188.  7a. 1                       - !Freenet announcement 1.<p>
  189.  
  190.  7b  2                       - !Freenet announcement 2.<p>
  191.  
  192.  7c  3                       - Program description.<p>
  193.  
  194.  7d  FreeNSetUp     - How to set up !Freenet applications.<p>
  195.  
  196.  7e  FreeNSite         - !Freenet ftp site.<p>
  197.  
  198. <p>
  199.  
  200. !Freenet has only just been released and these documents are a brief introduction to !Freenet, what it does & 
  201. where to find it.         <p>
  202.  
  203. The software described below may not be the “best” or most elegant way of accessing Demon Internet, but 
  204. it all works and is fairly simple to configure. New software for accessing the Internet apears nearly every 
  205. month. I will make no attempt to keep the Starter-Pack up-to-date with every version change etc, but will 
  206. review it with major version changes and when important new software is released, stable and documented. <p>
  207.  
  208. To get started, you will need:<p>
  209.  
  210. !SparkPlug<p>
  211.  
  212. !DemConfig   >>>  - Will configure all the rest & create !NewsDir<p>
  213.  
  214. !TCPIP<p>
  215.  
  216. !TCPIPUser<p>
  217.  
  218. !TTFN<p>
  219.  
  220. !NewsBase<p>
  221.  
  222. !Slipdial<p>
  223.  
  224. !SerialApps  >>>  - Contains !SerialDev (serial device drivers)<p>
  225.  
  226. Utilities         - Contains !UUcoder & newgroups                  <p>
  227.  
  228. <p>
  229.  
  230. !Sparkplug is a great little program for unpacking files. It is supplied as a self-extracting basic program in the starter-pack. Make sure that the  file-type option is set to Basic, then double-click over the basic 
  231. program Sparkplug. It will unpack itself and place itself in your root directory. <p>
  232.  
  233. Double-click on the !SparkPlug icon to load it onto the icon-bar. To unpack everything else, drop their icons 
  234. onto !SparkPlug on the icon-bar. You will use this program time and again to unpack archives from the 
  235. Internet. The latest version can be found by ftp’ing to demon in:  /pub/archimedes/utils. <p>
  236.  
  237. <p>
  238. <h3>Let’s Go !!!</h3>
  239.  
  240. <p>
  241.  
  242. Before you start, you should know:<p>
  243.  
  244. 1. Your nodename (mine is midwife)<p>
  245.  
  246. 2. Your IP address (mine is 158.152.38.98)<p>
  247.  
  248. 3. Your password (keep it a secret!)<p>
  249.  
  250. <p>
  251.  
  252. NB. You <em>MUST</em> have this information for the rest of the setup to succeed. !DemConfig can try to get it for 
  253. you, but several users have reported difficulties with this part of the Starter-Pack and it’s only fair to warn 
  254. you about this. Demon Support should be able to give you this initial information if you have problems.<p>
  255.  
  256. Create a directory to store all your Internet applications in;<p>
  257.  
  258. eg. ADFS::IDEdisc4.$.Internet<p>
  259.  
  260.     SCSI::HardDisc5.$.Comms<p>
  261.  
  262. Unpack (use !Sparkplug for this) the programs into your Internet directory.<p>
  263.  
  264. When you have finished, your directory structure should look like this:<p>
  265.  
  266. ADFS::IDEDisc4.$.Internet (directory)<p>
  267.  
  268. !DemConfig            Application<p>
  269.  
  270. !NewsBase                “<p>
  271.  
  272. !TTFN                       “<p>
  273.  
  274. !TCPIP                      “<p>
  275.  
  276. !TCPIPUser               “   <p>
  277.  
  278. !Slipdial                     “<p>
  279.  
  280. !NewsDir              This will be created by !DemConfig  <p>
  281.  
  282. SerialApps             <dir><p>
  283.  
  284. !SerialDev            Unpack this application from the SerialApps <dir><p>
  285.  
  286. Utilities              <dir> <p>
  287. Docs                  The Guide & FAQs <dir><p>
  288.  
  289. <p>
  290.  
  291. !SerialDev & !Sparkplug may reside in this directory if you wish, as may any other files or directories. 
  292. When you have connected to the Internet you may wish to add other applications (eg !ChangeFSI !Freenet 
  293. & the various WWW (World-Wide-Web fetchers) so this directory could become quite large very quickly.<p>
  294.  
  295. <p>
  296. <h3>1. !DemConfig</h3>
  297.  
  298. <p>
  299.  
  300. If you have never logged on to Demon, and you don’t have a password or IP address, !DemConfig can now 
  301. carry out an initial logon for you. A new option “Call Demon now to get IP address” has been added. If you 
  302. select this option, then when you click on the Configure button, !DemConfig starts up !SLIPdial with a 
  303. special script which dials Demon to perform the initial login.  The purpose is to set a password and to get 
  304. your IP address, which is needed by !TCPIP.  Note that !DemConfig closes down while this login is being 
  305. done; it is restarted when the SLIPdial script completes.  The script can cope if the password has already 
  306. been set (as long as you don’t change it).<p>
  307.  
  308. !DemConfig no longer deletes the !NewsDir directory when run, so  !DemConfig can now safely be used 
  309. many times without losing mail or news.<p>
  310.  
  311. Whenever you click on the <Configure> button, !DemConfig saves the choices made so far.  So if you make 
  312. a slight modification, you don’t have to enter everything again from scratch.<p>
  313.  
  314. As software upgrades become available - update each application separately & do not use !DemConfig 
  315. unless you want to start again.<p>
  316.  
  317. !DemConfig will make initial configuration of your Internet software very easy! Double-click over the 
  318. application icon to run !DemConfig and the dialogue window will open. Fill in the dialogue boxes as shown 
  319. below.<p>
  320. <em>
  321. NB. !DemConfig supports the Acorn !Help application, so interactive help is available for you as you 
  322. start the program.</em><p>
  323.  
  324. !DemConfig will then configure your Starter-Pack software for you. <p>
  325. <strong>
  326. !DemConfig - dialogue window;</strong><p>
  327.  
  328. Modem & Serial Interface:<p>
  329.  
  330. Modem type:      Select from list (if you choose “other” the driver just sends the “ATZ” string.<p>
  331.  
  332. Serial port:          Internal for standard ACORN machine or SP_Dual if you have “The Serial Port’s” dual       
  333.                            card fitted. If a commercially obtained PC-wired modem lead is being used, then the block   
  334.                            driver name must be specified as SP_DualPC. An “ARC” wired lead must be used with        
  335.                            SP_Dual.<p>
  336.  
  337. Cable type:        Acorn or PC<p>
  338.  
  339. Serial speed:     This is the serial port speed (not the modem speed). It will always work if you set it to “0”,    
  340.                           though you areunlikely to get the best possible performance. Try increasing it in multiples     
  341.                           of 19200 - so an A5000 or RISC PC will typically be able to run at 57600.<p>
  342. Phone details<p>
  343.  
  344. Mercury Button:  Press to select/deselect Mercury dialler info to be added to demonconfg file in !Slipdial.<p>
  345.  
  346. Mercury PIN:      132 or 131,xxxxxxxxxx <<< the comma after the 131 is <em>vital!</em><p>
  347.  
  348. Use Mercury for                                                                                                                                                     
  349. all PoPs:              Toggle on/off by selecting/de-selecting.<p>
  350.  
  351. Nearest PoP:       Select your nearest vPoP from the menu button.<p>
  352.  
  353. 2nd choice PoP:  As above.<p>
  354.  
  355. 3rd Choice PoP:  As above.<p>
  356.  
  357. Demon Account:<p>
  358.  
  359. Node name:        Your nodename (mine is midwife)<p>
  360.  
  361. Password:           Enter your new password (keep this secret) Passwords should be 6 characters minimum &    
  362.                            <em>MUST</em> include at least one letter and number (eg abc1xyz)<p>
  363.  
  364. IP address;          158.152.38.98 (this is mine)<p>
  365.  
  366. <p>
  367. <em>
  368. *** Select the “Call Demon now to get IP address” button if you need to set a password & collect your 
  369. IP address, otherwise turn it off ***</em><p>
  370.  
  371. <p>
  372.  
  373. User details:<p>
  374.  
  375. Userid:               “jbloggs” - or whatever you call yourself! - I’m “alan”.<p>
  376.  
  377. Name:                 Full name - I’m Alan Hassey!<p>
  378.  
  379. Organisation:    Optional - I’m at “The Hacienda” (geddit?).<p>
  380.  
  381. <p>
  382.  
  383. Then press the <kbd><Configure></kbd> button.<p>
  384.  
  385. The !NewsDir application will be created during configuration and added to your Internet directory.<p>
  386.  
  387. You will be informed when the configuration process is complete.<p>
  388.  
  389. Most of the work is now done :-)<p>
  390.  
  391. If you want more information on the !DemConfig application look at the !DemConfig Help file:<p>
  392. <cite>
  393. (ref !Help = !DemConfig.!Help)</cite><p>
  394.  
  395. <p>
  396. <h3>2. !TCPIP (KA9Q) & !TCPIPUser</h3>
  397.  
  398. <p>
  399. TCP = Transmission Control Protocol, IP = Internet Protocol = TCPIP<p>
  400.  
  401. TCPIP is your interface with the Internet. It receives and sends messages to and from the Internet and RISC 
  402. OS applications. Confusingly, TCPIP is also known as KA9Q. TCPIP (KA9Q) must be carefully configured 
  403. before you can use it. The programs share information - so be wary of making changes anywhere! If you 
  404. want to experiment, then keep a COMPLETE backup of your Internet directory somewhere safe...you have 
  405. been warned! <p>
  406.  
  407. !DemConfig will configure !TCPIP & !TCPIPUser for you. You do not need todo anything else. However, 
  408. if you want to alter your !TCPIP configuration then either change the data in the !Setup file and run !Config 
  409. or run !DemConfig again.<p>
  410. <cite>
  411. (ref !Setup = !TCPIPUser.TCPIP_New.!Setup)<p>
  412.  
  413. (ref !Config = !TCPIPUser.TCPIP_New.!Config) </cite><p>
  414.  
  415. !TCPIP is a complicated program to get to know. It may well be worth yourwhile loading and running 
  416. !TCPIP by itself so you can explore & experiment a bit without damaging your phone bill. <p>
  417. <h4>TCPIP Hints: </h4>
  418.  
  419. I strongly suggest you look at the macros menus available from the TCPIP main window (to the R of the top 
  420. dialogue box). When using ftp (file transfer protocol) I suggest you set the “path”option to “auto”. This will 
  421. ensure that you download files with the correct filetype. You need to do this at the beginning of each ftp 
  422. session.<p>
  423.  
  424. (This can also be done via the ftpopt command in the !TCPIPUser.Config file, or by creating a command 
  425. file called via the aftp command). <p>
  426. <em>
  427. NB. Remember the RISC OS 10 character filename limit!!!</em><p>
  428.  
  429. Most ftp sites are Unix-based & allow long-filenames. If you forget & “get” 2 imaginary files from an ftp 
  430. site, eg:<p>
  431.  
  432. 1.<kbd> get arcNetprog_0.45.spk (Unix long filename)</kbd><p>
  433.  
  434. 2. <kbd>get arcNetprog_0.45.txt</kbd><p>
  435.  
  436. They will both be downloaded with the name “arcNetprog” (10 chars) & the 2nd file will over-write the 
  437. first, so you lose it!  Use the “get” command like this:<p>
  438.  
  439. 1. <kbd>get arcNetprog_0.45.spk aNet045spk</kbd> <p>
  440.  
  441. 2. <kbd>get arcNetprog_0.45.txt aNet045txt</kbd><p>
  442.  
  443. This version of the “get” command gets the files & renames them:<p>
  444. <kbd>
  445. get <long_filename> & rename as <short_filename></kbd> <p>
  446.  
  447. So you will end up with the 2 files aNet045spk & aNet045txt in your Downloads directory.<p>
  448.  
  449. If you set the path to “auto” from the macros menu, then TCPIP will attempt to download the file into a 
  450. directory of the appropriate filetype. So you will receive the above xxx.spk file into 
  451. <dir>:downloads.archives & xxx.txt file into <dir>:downloads.Docs<p>
  452.  
  453. <p>
  454. The “get” command is supplemented by “mget” (multiple get) which can be used to get several files. The 
  455. format for the command is:<p>
  456. <kbd>
  457. mget <filename1> <filename2> <filename3></kbd> etc <p>
  458.  
  459. Which means get filename1 & get filename2 & get filename3 etc. Filenames should be separated by spaces.<p>
  460.  
  461. NB. If you use “mget”, make sure you set the “path auto” option first because the <long_filename> 
  462. <short_filename> option has been replaced by mget <filelist.....><p>
  463.  
  464. <p>
  465. <h4>aftp</h4>
  466.  
  467. <p>
  468.  
  469. I have included some ftp “accounts”, these are for:<p>
  470.  
  471. 1) Demon ftp<p>
  472.  
  473. 2) Graham Allen’s mnhep ftp site (for !NewsBase upgrades)<p>
  474.  
  475. 3) The !Freenet site at Southampton<p>
  476.  
  477. To access these type:<p>
  478.  
  479.    <kbd>aftp demon <return> </kbd>for demon<p>
  480.  
  481.    <kbd>aftp mnhep <return> </kbd>for the !NewsBase site<p>
  482.  
  483.    <kbd>aftp cslib <return></kbd> for the !Freenet site<p>
  484.  
  485. <p>
  486.  
  487. I’m not going into great detail about the aftp command but it is so useful it deserves this special mention. 
  488. The aftp command for either logs you into the appropriate ftp site and sets various parameters as follows:<p>
  489.  
  490.         prompt short<p>
  491.  
  492.         trace 0<p>
  493.  
  494.         path auto<p>
  495.  
  496.         i<p>
  497.  
  498.         hash 1<p>
  499.  
  500. This aftp setup is fairly safe & will not do anything silly. The setup parameters passed in this file set path 
  501. auto, binary filetype (i) and hash 1. <p>
  502.  
  503. <p>
  504.  
  505. For more detail - see the help files etc written by Adam Goodfellow and enclosed in the Starter-Pack 
  506. !TCPIP application within the TCPIP_Doc <Dir>.<p>
  507. <cite>
  508. (ref !ReadMe = !TCPIP.TCPIP_Doc.Notes & TCPIP_Doc.History)</cite><p>
  509.  
  510. <p>
  511. <h4>More Macro Menus!</h4>
  512.  
  513. I have included some extra macros menus for you to try, supplied by other users. These offer some extra 
  514. services via the macros menu. There are 2 alternative “ftp” menus and a “Talkers” menu. The “Talkers” 
  515. menu should replace the “Main” menu in: !TCPIPUser.Menus - after you have UUdecoded it! (Use 
  516. !UUcoder for this). Each of the AltMenus includes directions and advice.<p>
  517. <cite>
  518. (ref alternative menus = !TCPIPUser.Menus.AltMenus)</cite><p>
  519.  
  520. I have also enclosed the old ArcKA9Q manual which is rather out of date but gives some useful tips on 
  521. TCPIP commands. This has been renamed Guide1_21 and can be found in the FAQs directory.<p>
  522. <cite>
  523. (ref Guide1_21 = StarterPak.Docs.FAQs.Guide1_21)</cite><p>
  524.  
  525. I suggest you do not make any changes to your configuration files based on this old document until you 
  526. know what you are doing!<p>
  527.  
  528. Trying to get to grips with !TCPIP is the most difficult part of this whole process. Don’t waste too much 
  529. time on it - you can connect, send & receive mail/news, logout, read  & reply to your mail/news & never 
  530. issue a !TCPIP command directly! You will need some basic commands to do telnet or ftp sessions. Even so 
  531. - don’t get bogged down in !TCPIP - it’s about to be replaced by !Freenet which has a whole new set of 
  532. commands to worry about :-)<p>
  533.  
  534. <p>
  535. <h3>3. !NewsBase</h3>
  536.  
  537. <p>
  538.  
  539. !NewsBase works with TTFN to process news and mail. The NewsBase program basically splits the 
  540. downloaded news file into separate messages. The news file is often referred to as a “news batch”, and the 
  541. process of splitting it up is often referred to as “debatching”.<p>
  542.  
  543. !NewsBase now supports the Acorn interactive help program and !StrongHelp. There is no longer a “Docs” 
  544. directory within !NewsBase, so use the inter-active help - it’s very good.<p>
  545.  
  546. Double-click on !NewsBase to load it onto the icon bar. The first thing !NewsBase will try to do is look for 
  547. the !NewsDir application. If it does not exist, then !NewsBase will create !NewsDir in your Internet 
  548. directory.<p>
  549.  
  550. If you change your setup, or accidentally delete !NewsDir, then you will be warned, that !NewsBase cannot 
  551. find !NewsDir. A News Directory box will appear, drag the icon to your Internet directory, where your new 
  552. !NewsDir will be placed. <p>
  553. <em>
  554. NB. Remember to keep all your applications in the same directory. (Or at least on the same disk!)</em><p>
  555.  
  556. !NewsBase will then start and will attempt to configure itself from the data you supplied to !DemConfig. 
  557. When NewsBase has finished, you will be notified of the arrival of four new articles & mail for postmaster. 
  558. Click on the <kbd><Read></kbd> button to install !TTFN on the icon-bar. !TTFN is your news & mail reader program 
  559. (see below).<p>
  560.  
  561. !NewsBase has more detailed setup options and you can look at these by clicking <kbd><menu></kbd> over the 
  562. !NewsBase icon & selecting <kbd><setup>,</kbd> or by clicking with <kbd><adjust></kbd>. The NewsBase Control Panel will 
  563. appear, with 6 options for configuring or reconfiguring !NewsBase, these are:<p>
  564.  
  565. <p>
  566. 1. Site<p>
  567.  
  568. 2. General<p>
  569.  
  570. 3. Transports<p>
  571.  
  572. 4. Groups<p>
  573.  
  574. 5. Configure Users<p>
  575.  
  576. 6. Filters<p>
  577.  
  578. <p>
  579.  
  580. 1. Site - should need no further attention. <p>
  581.  
  582. 2. General - no need for further entries now.<p>
  583.  
  584. 3. Transports - should read ka9q. Leave this alone unless you know about Taylor, soup & uucp.<p>
  585.  
  586. 4. Groups - a suggested group list is given below and I recommend that  you read the !NewsBase 
  587. documentation carefully here.<p>
  588.  
  589. 5. Users - change the Username to your name from the options list and press <kbd><Save></kbd>.<p>
  590.  
  591. 6. Filters - I suggest you leave this option alone until you have read  the !NewsBase documentation 
  592. carefully. No need for further entries now.<p>
  593.  
  594. <p>
  595.  
  596. !NewsBase holds information on newsgroups of 2 types :-<p>
  597.  
  598. 1. Those in the “Newsfeed”<p>
  599.  
  600. 2. Those in the “Database”, ie. those with files in !NewsDir.<p>
  601.  
  602. To add more newsgroups, select the “Newsfeed” option & enter the name of the group(s) you wish to 
  603. receive. Wildcards are valid, so entering:<p>
  604. <kbd>
  605. comp.sys.acorn*</kbd> will ensure you get all the groups under this hierarchy.<p>
  606.  
  607. Groups in the newsfeed will usually join the database list as traffic flows in that newsgroup. (This replaces 
  608. the old concept of “active” & “current” newsgroups in !NewsBase versions up to 0.54i)<p>
  609.  
  610. I have listed below a few newsgroups you might want to subscribe to:<p>
  611.  
  612. demon.ip.support.archimedes<p>
  613.  
  614. demon.announce<p>
  615.  
  616. demon.archives.announce<p>
  617.  
  618. demon.news<p>
  619.  
  620. comp.sys.acorn*             (This will give you all the acorn groups)<p>
  621.  
  622. news.announce.newusers<p>
  623. The groups:<p>
  624.  
  625. comp.sys.acorn.announce<p>
  626.  
  627. comp.sys.acorn.networking<p>
  628.  
  629. demon.announce<p>
  630.  
  631. demon.ip.support.archimedes<p>
  632.  
  633. are in the “Newsfeed” & should be fed to you anyway.<p>
  634.  
  635. A full list of newsgroups available via Demon can be obtained by ftp.<p>
  636. <cite>
  637. (ref list = ftp.demon.co.uk:/pub/news/active.zip (or active.Z).</cite><p>
  638.  
  639. <p>
  640.  
  641. !NewsBase can also work with the !Groups application. This is a very nice little program which makes 
  642. editing the newsgroup database very easy. !Groups is included in the !NewsBase autoboot <dir> and is 
  643. accessed via the !NewsBase icon menu by selecting the “New Groups...” option. It can be configured to edit 
  644. newsgroup details either from a database of all newsgroups (eg active.zip above) or from your own defined 
  645. feed. <p>
  646.  
  647. For !Groups to work it must be able to find the file: <p>
  648.  
  649. !NewsDir.newsbase.newgroups.<p>
  650.  
  651. This file will not be created until after your first connection to Demon. I have included a “dummy” 
  652. newgroups file which you should move from the Utilities <Dir> to !NewsDir.newsbase, so you can access 
  653. the !Groups program. To add groups to the newsfeed, drag them from the “New groups” window to the 
  654. “Your news feed” window“. To delete groups from the newsfeed, click <kbd><adjust></kbd> over the group to be 
  655. deleted. You will be asked to confirm group changes.<p>
  656.  
  657. If you have (or get) a copy of Active.zip, you can use !Groups to add all  the newsgroups you want by 
  658. pressing mouse <kbd><menu></kbd> over the Newsgroups display window & <kbd><select></kbd>ing the <kbd>“Configure...”</kbd> option. 
  659. Unzip the file & drag it to the configuration window and you will have a choice of thousands of 
  660. newsgroups.<p>
  661.  
  662. The !Groups program contains full details of setup and operation. <p>
  663. <cite>
  664. (ref !Groups = !NewsBase.Autoboot.!Groups)<p>
  665.  
  666. (ref newgroups = !Utilities.newgroups) move to (!NewsDir.newsbase)<p>
  667.  
  668. (ref Help = !NewsBase.Autoboot.!Groups.!Help)<p>
  669. </cite>
  670. <p>
  671.  
  672. This version of !NewsBase also includes access to the !Qedit program.  This allows you to view the mail/
  673. news queue and perform a variety of operations on  it. To access !Qedit, press <kbd><menu></kbd> over the !NewsBase 
  674. icon on the icon-bar and choose the <kbd>“Queues...”</kbd> option. Menu and help screen are available by clicking <kbd>
  675. <menu> </kbd>over the !Qedit window. A !Help file is also available within the program application directory. 
  676. !Qedit can also be accessed via the macros menu of !TCPIP.<p>
  677. <cite>
  678. (ref !Help = !TCPIPUser.AutoBoot.!Qedit.!Help)</cite><p>
  679. <h3>4. !NewsDir</h3>
  680.  
  681. <p>
  682.  
  683. This application stores your news & mail. It also stores some configuration information for !NewsBase & 
  684. some information about you. It is worth having a look at your UserHome directory & setting up your 
  685. signature & userinfo details.<p>
  686. <cite>
  687. (ref = !NewsDir.UserHome.yourname <dir>)</cite><p>
  688.  
  689. <p>
  690. <h3>5. !TTFN</h3>
  691.  
  692. <p>
  693.  
  694. (TTFN = The Thread Following NewsReader)<p>
  695.  
  696. This is the news & mail reader provided to work with NewsBase. This should be installed on the icon-bar 
  697. with your name underneath. If not, double-click on its icon in the Starter-Pack to load !TTFN. <p>
  698.  
  699. You will have noticed a “New Newsgroup Created” box has appeared,  asking if you would like to 
  700. subscribe to the newsgroup;  newsbase.announce.newusers. Click on <kbd><Yes>.</kbd><p>
  701.  
  702. The Newsgroups Status window for user “you” will now appear. Select the radio-button on the left to enable 
  703. thread-following. This allows you to collect together news/mail with the same subject-line as a “thread”.<p>
  704.  
  705. Double-click on the line newsbase.announce.newusers and the titles of four articles will appear. These 
  706. articles are actually regularly posted FAQs which you should read.<p>
  707.  
  708. Click <kbd><menu></kbd> over the !TTFN icon & change the user to “postmaster”. You will find some Email is waiting 
  709. for “postmaster”.<p>
  710.  
  711. !TTFN’s setup screens are accessed via <kbd><menu></kbd> or <kbd><adjust></kbd> from the icon-bar.  Setup is easy and the 
  712. documentation provided is very good. You do not need to make any changes to TTFN Setup unless you 
  713. want to. Press<kbd> <Save> </kbd>to store any changes permanently.<p>
  714.  
  715. To subscribe a new user to the currently available newsgroups, click on the TTFN menu & select the <kbd>
  716. “Users...</kbd>” option. From here, select <kbd>“Create User”</kbd>. Give yourself an ID (mine is “alan”). Then click on 
  717. the “Group subscription” button to open the subscription list. Click on the groups you wish to join. If you 
  718. want to join a group which is not listed, then create the group via the “Groups” option in !NewsBase. This 
  719. option is not available until you have a list of groups created to choose from.<p>
  720. <cite>
  721. (ref !TTFN documentation = !TTFN.Docs.UserGuide)</cite><p>
  722.  
  723. <p>
  724.  
  725. Clicking <kbd><adjust></kbd> over the !TTFN icon, opens a scrollable Setup window. Open the address book. This 
  726. contains a few names and Email addresses for you. You can edit this list as you wish.<p>
  727.  
  728. <p>
  729. <h3>6. !Slipdial</h3>
  730.  
  731. <p>
  732.  
  733. Slipdial is your dialler program. It will run a script (default is Demon) which will connect you to the Demon 
  734. PoPs of your choice, then autoboot !TCPIP to connect you to Internet. When you disconnect from the Internet, the Demon script will load !TTFN & !NewsBase, commence debatching news & mail and advise 
  735. you when your news and mail is ready to read. <p>
  736.  
  737. You need to make sure your modem is properly configured to run !Slipdial. Demon produce a good FAQ to 
  738. help with modems & this is included in the FAQs directory:<p>
  739. <cite>
  740. (ref = ModemTxt = StarterPak.Docs.FAQs.Demon.ModemTxt)</cite><p>
  741.  
  742. This file gives full details on setting up your modem for connection to the Internet. <p>
  743. <em>
  744. NB. Most of the problems reported with !Slipdial are serial/cable problems (check your cable & your 
  745. serial driver).</em><p>
  746.  
  747. The information you supplied to !DemConfig will have created a file called “demconfg” (previously called 
  748. demonconfg in earlier versions of the Starter-Pack),  which you can view/edit in the scripts subdirectory. <p>
  749. <em>
  750. NB. Be careful of making ANY changes here.</em><p>
  751. <cite>
  752. (ref demconfg = !Slipdial.Scripts.demconfg)</cite><p>
  753.  
  754. To check or change the !Slipdial default script, click <kbd><menu></kbd> over the !Slipdial icon & select choices. The 
  755. default script will appear in the dialogue box in the format:<p>
  756.  
  757.  <kbd>ADFS::IDEdisc4.$.!Slipdial.Scripts.demon</kbd><p>
  758.  
  759. The Auto-run button should be ticked. You can choose to run other scripts eg. .....Slipdial.myscript or you 
  760. can deselect the Auto-run facility. I have included several example scripts for you to play with. <p>
  761.  
  762. If you are interested in writing your own scripts, then see Alan Fitch’s excellent ScriptHelp in the FAQs 
  763. directory.  (I suggest you read it anyway!)<p>
  764. <cite>
  765. (ref ScriptHelp = StarterPak.Docs.FAQs.ScriptHelp)</cite><p>
  766.  
  767. The default “Demon” script now uses the new Demon Virtual PoPs (vPoPs). This script also gives you 
  768. access to the new “local” facility for making local call connections & by-passing your Mercury PIN. (Only 
  769. relevant if you have a Mercury account & a local vPoP). The mew “Demon” script allows much more 
  770. control over dialling options and debugging. Full details are in ScriptHelp (see above).<p>
  771.  
  772. The “Demon” script allows you to specify which modem-driver you want. I’m always on the lookout for 
  773. new modem-scripts, so if you’ve got one that works - please send it to me & I’ll include it in the Starter-
  774. Pack.<p>
  775. <cite>
  776. (ref drivers = !Slipdial.Drivers.ReadMe)</cite><p>
  777.  
  778. !Slipdial can be controlled from the program window. Click on the program icon to open the !Slipdial 
  779. window. The <kbd>“Select...”</kbd> dialogue allows you to choose which script to run when the program is stopped, 
  780. or which PoP to call when the script is paused. The other icons on the right control: redialling, pause 
  781. (toggle) & stop.<p>
  782.  
  783. !DemConfig will configure !Slipdial for Mercury or BT use. <p>
  784.  
  785. <p>
  786. <h3>7. !SerialDev</h3>
  787.  
  788. <p>
  789. The serial device drivers are run under the !SerialDev application. !SerialDev be unpacked from the 
  790. SerialApps <dir> and placed in your internet or root directory:<p>
  791.  
  792. <p>
  793.  
  794. eg <kbd>ADFS::IDEDisc4.$.!SerialDev or <p>
  795.  
  796.   ADFS::IDEDisc4.$.Internet.!SerialDev</kbd><p>
  797. <cite>
  798. (ref !SerialDev = SerialApps.!SerialDev)</cite><p>
  799.  
  800. The rest of the SerialApps directory can be placed in a separate directory out of the way if you don’t need it. 
  801. You should always use the latest version of the drivers which are  available from demon in; <p>
  802.  
  803. /pub/archimedes/blockdrivers.<p>
  804.  
  805. They are a resource used by other applications which need to be able  to “see” them - hence put them in 
  806. your root directory, or if this is too untidy for you - then in your comms or Internet directory.<p>
  807. <em>
  808. NB. This version of the blockdrivers is compatible with !Freenet.</em><p>
  809.  
  810. The serial port on your computer can cause problems, especially if you have an early RISC OS 3 machine. 
  811. Various patches and modules are available to help remedy these problems - please refer to The AcornFAQ 
  812. in the documents directory sections 8a,b & the ReadMe file in the SerModules sub-directory. These patch 
  813. modules are included in the SerialApps directory. You will need them if you run RISC OS 3.1 or earlier. 
  814. Versions 3.11+ should be OK. Also included is a wiring diagram for an Arc modem lead connection 
  815. (SerialConn).<p>
  816. <cite>
  817. (ref AcornFAQ = StarterPak.Docs.AcornFAQ)<p>
  818.  
  819. (ref SerModules = StarterPak.SerialApps.SerModules)<p>
  820.  
  821. (ref ReadMe     = StarterPak.SerialApps.SerModules.ReadMe)<p>
  822.  
  823. (ref SerialConn = StarterPak.SerialApps.SerialConn)<p>
  824. </cite>
  825. <p>
  826. <h3>8. Utilities (!UUCoder & newgroups)</h3>
  827.  
  828. <p>
  829.  
  830. !UUcoder is in the Utilities <dir>. It makes UUencoding & decoding very easy. (!TTFN can also UUdecode 
  831. files for you). You will need it if you want to send binary files via Email. Full instructions are included 
  832. within the application. Try it out on the “Talkers” file mentioned earlier.<p>
  833. <cite>
  834. (ref Help = Utilities.!UUcoder.!Help)</cite><p>
  835.  
  836. The newgroups file should be moved into !MailDir.newsbase <Dir>. (See !Groups above)<p>
  837. <strong>
  838. That’s it - you are now ready to go!!!         :-)</strong><p>
  839.  
  840. <p>
  841. <h3>C. Running the software & connecting to the Internet</h3>
  842.  
  843. <p>
  844. <h4>*** Before you start ***</h4>
  845.  
  846. <p>
  847.  
  848. The commonest 2 reasons for failure to connect are:<p>
  849.  
  850. 1. You did not read the documentation properly.<p>
  851.  
  852. 2. Wrong combination of serial-driver & modem-lead.<p>
  853.  
  854. These 2 reasons account for >90% of the calls I get because “Your *%$!@~? Starter-Pack does not 
  855. work........”.  So, before you call me or any of the authors, please:<p>
  856.  
  857. 1. RTFM :-)<p>
  858.  
  859. 2. Check your modem-lead & serial setup.<p>
  860.  
  861. <p>
  862. <h3>So what next?</h3>
  863.  
  864. <p>
  865.  
  866. I suggest you reboot your machine & then open your Internet directory. Remember that the applications 
  867. need to have “seen” the !SerialDev, !Scrap & !System applications to work properly.<p>
  868.  
  869. Double-click on !Slipdial, which will load onto the icon-bar & open its dialogue box. Wait a second or two 
  870. for the appropriate script to load, select your vPoP from the menu & double-click. Your modem will now 
  871. dial-out & connect you to your chosen PoP. Or click over the “Local” icon to direct-dial your local vPoP. <p>
  872.  
  873. !Slipdial will display several messages as it connects & logs in. When a full connection is established, it will 
  874. boot !TCPIP & install it on the icon-bar. Mail & news can now be sent/retrieved via the smtp & nntp kick 
  875. commands. (This can be automated via your !TCPIPUser.AutoExec file).<p>
  876.  
  877. You will be notified of incoming mail and news, which you can read via !TTFN & !NewsBase.<p>
  878.  
  879. A selection of commonly used commands are available directly from the macros menu at the top right of the 
  880. TCPIP main screen. At first, it may well be worth changing to the long time-out option (also via the macro 
  881. menu) so that TCPIP does not hang up before you have had an opportunity to find your way around.<p>
  882.  
  883. When you have finished your session(s), log-out by typing “<kbd>quit</kbd>” & pressing the<kbd> <RETURN></kbd> key. !Slipdial 
  884. will disconnect, stop !TCPIP & remove it from the icon-bar. It will then load !TTFN & !NewsBase. Your 
  885. news and mail will be debatched for reading. <p>
  886.  
  887. If you decide to dial back into the Internet, !Slipdial will remove !TTFN & !NewsBase from the icon-bar as 
  888. it runs the script-file again.<p>
  889.  
  890. When quitting altogether, it is wiser to do a controlled shutdown via the ACORN icon (or <kbd>CTRL+SHIFT+F12</kbd>) 
  891. than a reset (<kbd>CTRL+BREAK</kbd> or <kbd>RESET</kbd> button)<p>
  892.  
  893. Have fun and please let me know how the ACORN RISC OS 3.1+ Internet Starter-Pack could be improved <p>
  894.  
  895. <p>
  896. <h3>D. Acknowledgements</h3>
  897.  
  898. <p>
  899.  
  900. To all the authors who agreed to the inclusion of their programs, FAQs & other documents in the Starter-Pack;<p>
  901.  
  902. *  Robert Orwin for !TTFN.<p>
  903.  
  904. *  Graham Allen for !Slipdial<p>
  905.  
  906. *  Graham Allen, Thomas Aeby & Gunnar Zotl for !NewsBase.<p>
  907.  
  908. *  Adam Goodfellow, Anthony Frost & Jonathan Naylor for !TCPIP.<p>
  909.  
  910. *  David Pilling for !SparkPlug & SerialBuff.<p>
  911.  
  912. *  Hugo Fiennes for !SerialDev.<p>
  913.  
  914. *  Colin Hogben for !DemConfig.<p>
  915.  
  916. *  David Croft for !Qedit & !Groups.<p>
  917.  
  918. *  John Allen for !UUcoder.<p>
  919.  
  920. *  David Dade & ACORN Ltd for the serial modules.<p>
  921.  
  922. *  Paul Allen & The ARM Club for the KA9Q guide1_21.<p>
  923.  
  924. *  Alan Fitch for  !ScriptHelp & the “Demon” !Slipdial script.<p>
  925.  
  926. *  Demon Internet Ltd for the Demon documents. <p>
  927.  
  928. *  Kevin Quinn for the Acorn FAQ.<p>
  929.  
  930. *  Merlyn Kline for the Zynet FAQ.<p>
  931.  
  932. <p>
  933.  
  934. To everybody else who contributed and to you for using it.<p>
  935.  
  936. Comments & queries about specific software should be addressed to the authors as follows;<p>
  937.  
  938. <p>
  939.  
  940. ¤  !TTFN                                ttfn@wong.demon.co.uk<p>
  941.  
  942. ¤  !NewsBase  & !Slipdial     allan@mnhep1.hep.umn.edu<p>
  943.  
  944. ¤  !Slipdial scripts                  alan@cycle.demon.co.uk<p>
  945.  
  946. ¤  !TCPIP & !TCPIPUser      tcpip2@comptech.demon.co.uk<p>
  947.  
  948. ¤  !SerialDev                         altman@cryton.demon.co.uk<p>
  949.  
  950. ¤  !DemConfig                      colin@nyphot.demon.co.uk<p>
  951.  
  952. ¤  !Qedit                                david@runge1.demon.co.uk<p>
  953.  
  954. ¤  !SparkPlug & SerialBuff   david@pilling.demon.co.uk<p>
  955.  
  956. ¤  SerialUtil & SerialDev      david@arcade.demon.co.uk<p>
  957. ¤  !UUcoder                         john@bramber.demon.co.uk<p>
  958.  
  959. ¤  Guide1_21                       pla@sktb.demon.co.uk<p>
  960.  
  961. ¤  AcornFAQ                       afaiq@banana.demon.co.uk<p>
  962.  
  963. ¤  Demon Internet                internet@demon.net<p>
  964.  
  965. ¤  Zynet                                merlyn@zynet.co.uk <p>
  966.  
  967. ¤  Guide (This doc)              alan@midwife.demon.co.uk<p>
  968.  
  969. <p>
  970.  
  971. I hope I have adequately acknowledged the contributions of all the main authors. I have tried hard to ensure 
  972. that all the authors’ own copyrights and conditions of use are maintained. If I have made any errors, then I 
  973. apologise in advance and undertake to correct them as soon as possible.<p>
  974.  
  975. Thanks also to everybody who has sent me modem driver files - please keep them coming!<p>
  976.  
  977. <p>
  978.  
  979.                              Alan Hassey (alan@midwife.demon.co.uk)<p>
  980.  
  981.                              <p>
  982.  
  983. <!-- (4604: Alan Hassey) -->
  984. </body>
  985. </html>
  986.